home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / ts3st17.zip / STATTRAN.INF < prev   
Text File  |  1992-09-22  |  11KB  |  255 lines
  1.                            - 1 -
  2. Tue 22-September-1992                          (All rights reserved)
  3.  
  4. About TS3ST in General  (Statistics: Transformations of observations)
  5. ======================
  6.  
  7. Apply question mark ? with the program call for a brief description
  8. of a program.
  9.  
  10. This package may be used and distributed freely for NON-COMMERCIAL,
  11. NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
  12. any way.
  13. ┌────────────────────────────────────────────────────────────────┐
  14. │ For ANY other usage (such as use in a business enterprise or a │
  15. │ university) or the full scale version contact the author for a │
  16. │ personal or a site license.                                    │
  17. └────────────────────────────────────────────────────────────────┘
  18. Please do not distribute any part of this package separately.
  19. Uploading to BBSes is encouraged.
  20.  
  21. The registered version is strictly for the registrant only.
  22. Identical programs must NOT be running on more than one computer at
  23. a time. Site licensed programs must not be run outside the licensed
  24. site.
  25.  
  26. The programs are under development. Comments and contacts are
  27. solicited. If you have any questions, please do not hesitate to use
  28. electronic mail for communication.
  29. InterNet address: ts@uwasa.fi         (preferred)
  30. Bitnet address:   SALMI@FINFUN
  31.  
  32. The author shall not be liable to the user for any direct, indirect
  33. or consequential loss arising from the use of, or inability to use,
  34. any program or file howsoever caused. No warranty is given that the
  35. programs will work under all circumstances.
  36.  
  37. Timo Salmi
  38. Professor of Accounting and Business Finance
  39. Faculty of Accounting and Industrial Management
  40. University of Vaasa
  41. P.O. BOX 297, SF-65101 Vaasa, Finland
  42.  
  43. EX2FL.EXE copyright (c) is by Programmer Tuomas Eerola
  44. Computer Centre, University of Vaasa
  45. P.O. BOX 297, SF-65101 Vaasa, Finland
  46.  
  47. CONTENTS:
  48.  
  49.   1. General Description of STATTRAN.EXE
  50.   2. Use as an Editor
  51.   3. Exponential to floating converter EX2FL.EXE
  52.   4. Release Notes for STATTRAN.EXE
  53.   5. PD Programs for PC Compatibles by Timo Salmi
  54.   6. The Statistics Set for Other Computers
  55.   7. List of the files in the package
  56.  
  57.                            - 2 -
  58.  
  59.  
  60. 1. GENERAL DESCRIPTION
  61.  
  62. STATTRAN (Ver 1.7)
  63.  
  64.    STATistics: TRANsformations is part of the interactive
  65. statistical system by Timo Salmi. It is the third program in the
  66. set. It can be used for transforming the observations, and, if
  67. necessary, even as an editor. The first program in the set is
  68. STATistical MEASures (TS1STxx.ZIP), which is intended for univariate
  69. analysis. The second program in the set is STATistics: multiple
  70. REGRession analysis (TS2STxx.ZIP). The fourth program in the set is
  71. STATistics: Ranks and CORrelations (STATRCOR in TS4STxx.ZIP). The
  72. fifth program in the set is STATistics: Least Absolute Deviation
  73. multiple Regression (STATLADR in TS5STxx.ZIP).
  74.    STATTRAN includes a built-in help system, which can be invoked by
  75. typing ? at any interactive question. Because of this built-in help,
  76. and the interactive nature of the program's user interface, no
  77. long-winding instructions have been included. (Who reads
  78. instructions anyhow?)
  79.  
  80.    The following transformations are available
  81.     LOGAE is ln(x(i)),       i.e. takes the natural logarithm.
  82.     LOGAR is log(x(i)),      i.e. takes the logarithm in a given base.
  83.     POWER is x(i)^a,         i.e. raises to the given power.
  84.     SCALE is a*x(i),         i.e. scaling with a constant coefficient.
  85.     MULTI is y(i)*x(i),      i.e. multiplies a variable with another variable.
  86.     DEFLA is y(n)/y(i)*x(i), i.e. deflates a variable with another variable.
  87.     DIFFE is x(i)-x(i-1),    i.e. takes differences.
  88.     LAGLD is x(i+lag),       i.e. a lag or a lead.
  89.   The data can either be given from the keyboard or taken from a
  90. file. If the input is to be taken from a file it must first be
  91. prepared with some editor, or some word processor which includes an
  92. option for preparing ordinary ascii text. (Also STATTRAN can be used
  93. for this purpose.)
  94.    The data is given to the program in the following format:
  95.  
  96.        X1 X2 X3                !variable names (! denotes a comment)
  97.        3.56 6.32 -1.73
  98.        5.12 -4.21 9.18
  99.        14.2 5.11 0.31
  100.        END                     !END is optional in a file
  101.  
  102. A missing item in an observation is marked by a hash (#). E.g. if
  103. the first item of the second observation were missing, the
  104. observation should be written as  # -4.21 9.18
  105.    The items in an observation can be separated with blanks, as in
  106. the above, or with commas (,) e.g. 5.12,-4.21,9.18. The number of
  107. the intervening blanks is irrelevant, and can be customized for
  108. increased readability. Thus e.g. 5.12 -4.21 9.18
  109. and    5.12    -4.21     9.18    are equivalent.
  110.    A row can be continued using an ampersand (&). E.g. the variables
  111. could be given as
  112.        X1 X2 &
  113.        X3
  114. Alternatively, * can be used instead of & as the continuation
  115. marker.
  116.    Comments can be added to the input data. If ! appears on a line
  117. all text after ! will be considered as a comment.
  118.    A header can be entered on each page if output is directed to a
  119. file. To accomplish this start the very first line on the input file
  120. with a double exclamation mark (!!) and the rest of the line will be
  121. used as the header. Thus !! indicates a header, a single ! an
  122. ordinary comment. Note that STATTRAN will omit all comments.
  123.    The maximum number of variables is 25. The maximum number of
  124. observations is 400 (for each variable). The public domain version,
  125. however, sets the limits at 4 and 100 respectively.
  126.  
  127.  
  128. 2. USE AS AN EDITOR
  129.  
  130.    STATTRAN can be used as a simple editor to prepare the data for
  131. the other statistics programs in the set. (Naturally, any editor
  132. will do.) The way to do this is to select the suitable options in
  133. STATTRAN as they come along: Choose giving the input from the
  134. keyboard (that is, not from a file), and directing the output to a
  135. file. Then select from the menu of transformations and actions the
  136. action SAVE. The data you have entered will be saved in your
  137. indicated output file in the proper format. If you wish to, you can,
  138. of course, also make transformations in the data during the same
  139. session.
  140.    An experienced user may also find useful the programs FILETRIM
  141. and FILEADD in TSFCOMxx.ZIP. The former can be used to extract
  142. columns from data files, and the latter to join them (side by side)
  143. into a new data file.
  144.  
  145.  
  146. 3. EXPONENTIAL TO FLOATING CONVERTER EX2FL.EXE (by Tuomas Eerola)
  147.  
  148. The programs in the statistics set do not allow the input data to be
  149. in the exponential format (such as e.g. 1.2345E+05). Such data must
  150. first be converted into the floating format (e.g 123450.0).
  151.  
  152. Usage: EX2FL Source.ext [Output.ext]
  153.  
  154. EX2FL.EXE converts a file containing exponent-type numbers to
  155. floating-point numbers. Default output is con, that is to screen.
  156.  
  157. Value range: 1E-15 ... 9.999E16
  158.  
  159.  
  160. 4. RELEASE NOTES FOR STATTRAN.EXE
  161.  
  162.    Version 1.1: Some internal changes.
  163.  
  164.    Version 1.2: Some of the routines of the Turbo Pascal code have
  165. been optimized for increased speed.
  166.  
  167.    Version 1.3:  This version introduces input recall and line
  168. editing. The special keys Del, CrLf, CrRg, CrUp, Home, End, and Esc
  169. are functional for this purpose. PgUp is the recall key. Line
  170. editing uses insert mode.
  171.  Disk access has been made faster (the program has its own cache).
  172.  The directory routine has been updated.
  173.  Read-only files can be read properly.
  174.  
  175.    Version 1.4: While fixing a bug in the multiple regression
  176. program I also made some enhancements in the routines which are
  177. common to all my statistical programs. Most importantly the insert
  178. key has been made functional in the line editing.
  179.  
  180.    Version 1.5: The line editing potential of the program has been
  181. improved. When the task is given from the keyboard, and continuation
  182. lines are used, the repeated input recall (CursorUp) gets each line
  183. in turn. Ctlr-C and break-key abort have been enhanced.
  184.  A line can be continued using an &, or a * at the end. Now also the
  185. backslash \ is accepted.  This was suggested by Tuomas Eerola.
  186.  Some help texts within the program have been extended.
  187.  
  188.    Version 1.6: Several improvements to the nuts and bolts of the
  189. user interface.
  190.    The new usage of the call is
  191. PROGNAME [/h(elp)] [/iInputFileName] [/oOutputFileName] [/cColumnsPerRow]
  192. (the /c option, which regulates the width of the output, is for
  193. registered versions, only). If you use the /i switch, it stuffs the
  194. InputFileName into the appropriate recall buffer. This means that
  195. when the program asks you for the input file name, you can invoke
  196. the input file name just by pressing the CursorUp key. (The same
  197. goes for the /o switch, respectively.) This is very convenient, if
  198. you use the program many times successively making small changes in
  199. your data in between. (This assumes, of course, that you have a
  200. command line editor like DOSEDIT or CED to recall previous MsDos
  201. commands. These common shareware programs can be obtained from any
  202. well-stocked BBS or FTP site.)
  203.    The printer readiness test has been rewritten to be more general.
  204. The earlier test failed for some printers, because the codes the
  205. printers send when they are offline are not standardized.
  206.    The "file exists, overwrite?" question is no more asked when the
  207. output file is prn, in other words when the output is directed to
  208. the printer.
  209.    The user has now a choice of a left margin from 0 to 20 blanks
  210. when output is directed to the printer.
  211.    The user has now a choice between formfeed and four blank lines
  212. to start each new page of output.
  213.    When an input file is not found, the user is given the choice of
  214. listing a directory. The directory routine has been rewritten.
  215.    The file ready message now also includes the file side besides
  216. the name.
  217.  
  218.    Version 1.7: The input and output file names can be optionally
  219. given as parameters in the program calls, e.g.
  220.       STATTAN /ic:\stat\test.dat /or:\tmp
  221. This option has  been improved.  The "prefilled"  name (e.g.
  222. c:\stat\test.dat) will now automatically appear on the input line
  223. without the need of pressing the cursor up key. All you need to do
  224. is to press enter.
  225.    Also made some minor internal changes not worth recording.
  226.    Rewrote the document files using a 68 column wrap instead of the
  227. former 80 to make the text easier to read and handle. Added the list
  228. of files in the package to the documentation.
  229.  
  230. 5. PD PROGRAMS FOR PC COMPATIBLES BY THE AUTHOR
  231.  
  232. See TSPROG.INF in ST1STxx.ZIP or in ST2STxx.ZIP.
  233.  
  234.  
  235. 6. THE STATISTICS SET FOR OTHER COMPUTERS
  236.  
  237.    The Statistical programs by Timo Salmi are also available for the
  238. Sinclair QL computer. Named STATPREP the system is part of a Public
  239. Domain library for QUANTA members. The descriptions of the files in
  240. the Quanta Library are given in STATMEAS.INF contained in
  241. TS1STxx:ARC, i.e. the first part of the set statistical programs.
  242.  
  243.  
  244. 7. LIST OF THE FILES IN THE PACKAGE
  245.  
  246. TS3ST Statistics by T.Salmi, Part III
  247. Filename        Comment
  248. --------        --------------------------------
  249. EX2FL.EXE       Exponents to float by T.Eerola
  250. FILE_ID.DIZ     Brief characterization of TS3ST
  251. STATTRAN.EXE    Transformations of observations
  252. STATTRAN.INF    Document
  253. ----            ------             ------  -----
  254. 0004
  255.